home *** CD-ROM | disk | FTP | other *** search
/ SGI Varsity Update 1998 August / SGI Varsity Update 1998 August.iso / docs6.4 / relnotes / pcp_eoe / ch2.z / ch2
Text File  |  1998-07-29  |  20KB  |  627 lines
  1.  
  2.  
  3.  
  4.                                   - 1 -
  5.  
  6.  
  7.  
  8.        2.  _I_n_s_t_a_l_l_a_t_i_o_n__I_n_f_o_r_m_a_t_i_o_n
  9.  
  10.        This chapter lists supplemental information to the _I_R_I_X
  11.        _A_d_m_i_n: _S_o_f_t_w_a_r_e _I_n_s_t_a_l_l_a_t_i_o_n _a_n_d _L_i_c_e_n_s_i_n_g _G_u_i_d_e.  The
  12.        information listed here is product- and release-specific;
  13.        use it with the _S_o_f_t_w_a_r_e _I_n_s_t_a_l_l_a_t_i_o_n _a_n_d _L_i_c_e_n_s_i_n_g _G_u_i_d_e to
  14.        install this product.
  15.  
  16.        2.1  _P_e_r_f_o_r_m_a_n_c_e__C_o_-_P_i_l_o_t__E_O_E__S_u_b_s_y_s_t_e_m_s
  17.  
  18.        The _p_c_p__e_o_e product includes these subsystems:
  19.  
  20.        _p_c_p__e_o_e._b_o_o_k_s._O_V_i_e_w_H_e_l_p
  21.                    SGIHelp book for the oooovvvviiiieeeewwww(1) application from
  22.                    _p_c_p__e_o_e._s_w._m_o_n_i_t_o_r.
  23.  
  24.        _p_c_p__e_o_e._b_o_o_k_s._P_m_R_u_n_H_e_l_p
  25.                    SGIHelp book for the ppppmmmmrrrruuuunnnn(1) application from
  26.                    _p_c_p__e_o_e._s_w._m_o_n_i_t_o_r.
  27.  
  28.        _p_c_p__e_o_e._b_o_o_k_s._P_m_T_i_m_e_H_e_l_p
  29.                    SGIHelp book for the ppppmmmmttttiiiimmmmeeee(1) application from
  30.                    _p_c_p__e_o_e._s_w._m_o_n_i_t_o_r.
  31.  
  32.        _p_c_p__e_o_e._m_a_n._p_a_g_e_s
  33.                    Manual pages for the tools and libraries.
  34.  
  35.        _p_c_p__e_o_e._m_a_n._r_e_l_n_o_t_e_s
  36.                    These release notes.
  37.  
  38.        _p_c_p__e_o_e._s_w._e_o_e
  39.                    Executable programs, libraries, scripts and
  40.                    configuration files that are required for every
  41.                    PCP deployment.
  42.  
  43.                    You need to install this subsystem if you wish
  44.                    to use any tools or products that use the PCP
  45.                    2.0 infrastructure.
  46.  
  47.        _p_c_p__e_o_e._s_w._m_o_n_i_t_o_r
  48.                    Some bundled performance monitoring tools.
  49.  
  50.        _p_c_p__e_o_e._s_w_6_4._e_o_e
  51.                    64-bit libraries that may be installed on 32-bit
  52.                    IRIX platforms for PCP developers.  Note that on
  53.                    64-bit IRIX platforms all required libraries
  54.                    (32-bit and 64-bit) are installed from
  55.                    _p_c_p__e_o_e._s_w._e_o_e and so it is expected that
  56.                    _p_c_p__e_o_e._s_w_6_4._e_o_e will nnnnooootttt be installed on most
  57.                    systems.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.                                   - 2 -
  71.  
  72.  
  73.  
  74.        2.2  _S_u_b_s_y_s_t_e_m__R_e_-_s_t_r_u_c_t_u_r_i_n_g__f_r_o_m__P_C_P__1_._x
  75.  
  76.        Some re-arrangement of the subsystem structure for the PCP
  77.        product occurred between versions 1.x and version 2.0, most
  78.        notably the splitting of _p_c_p into _p_c_p__e_o_e and _p_c_p.  The
  79.        table below describes the relationship between the changed
  80.        subsystems in the two versions.
  81.  
  82.               ______________________________________________
  83.                                         Corresponding
  84.                PCP 1.x Subsystem   Subsystem(s) for PCP 2.0
  85.               ____________________________________________________________________________________________
  86.                pcp.sw.collector    pcp_eoe.sw.eoe
  87.                                    pcp.sw.base
  88.               ______________________________________________
  89.                pcp.sw.eoe          pcp.sw.base
  90.                                    pcp_eoe.sw.eoe
  91.               ______________________________________________
  92.                pcp.sw.monitor      pcp_eoe.sw.monitor
  93.                                    pcp.sw.monitor
  94.               ______________________________________________
  95.                pcp.man.pages       pcp_eoe.man.pages
  96.                                    pcp.man.pages
  97.               ______________________________________________
  98.               |||||||||||||
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.                                  |||||||||||||
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.                                                             |||||||||||||
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.        2.3  _P_e_r_f_o_r_m_a_n_c_e _C_o-_P_i_l_o_t _E_O_E _S_u_b_s_y_s_t_e_m _D_i_s_k _S_p_a_c_e
  134.             _R_e_q_u_i_r_e_m_e_n_t_s
  135.  
  136.        This section lists the _p_c_p__e_o_e subsystems (and their sizes).
  137.  
  138.        If you are installing this product for the first time, the
  139.        subsystems marked ``default'' are the ones that are
  140.        installed if you use the ``go'' menu item.  To install a
  141.        different set of subsystems, use the ``install,''
  142.        ``remove,'' ``keep,'' and ``step'' commands in iiiinnnnsssstttt to
  143.        customize the list of subsystems to be installed, then
  144.        select the ``go'' menu item.
  145.  
  146.        Note:  The listed subsystem sizes are approximate. Refer to
  147.               the _I_R_I_X _A_d_m_i_n: _S_o_f_t_w_a_r_e _I_n_s_t_a_l_l_a_t_i_o_n _a_n_d _L_i_c_e_n_s_i_n_g
  148.               _G_u_i_d_e for information on finding exact sizes.
  149.  
  150.        Subsystem Name                   Subsystem Size
  151.                                         (Kbytes)
  152.        _p_c_p__e_o_e._b_o_o_k_s._O_V_i_e_w_H_e_l_p                400
  153.        _p_c_p__e_o_e._b_o_o_k_s._P_m_R_u_n_H_e_l_p                300
  154.        _p_c_p__e_o_e._b_o_o_k_s._P_m_T_i_m_e_H_e_l_p               350
  155.        _p_c_p__e_o_e._m_a_n._p_a_g_e_s                      200
  156.        _p_c_p__e_o_e._m_a_n._r_e_l_n_o_t_e_s (default)          20
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.                                   - 3 -
  171.  
  172.  
  173.  
  174.        _p_c_p__e_o_e._s_w._e_o_e (default)              2500
  175.        _p_c_p__e_o_e._s_w._m_o_n_i_t_o_r                     750
  176.        _p_c_p__e_o_e._s_w_6_4._e_o_e                       450
  177.  
  178.  
  179.  
  180.        2.4  _I_n_s_t_a_l_l_a_t_i_o_n__M_e_t_h_o_d
  181.  
  182.        All of the subsystems for _p_c_p__e_o_e can be installed using
  183.        IRIX.  You do not need to use the miniroot.  Refer to the
  184.        _I_R_I_X _A_d_m_i_n: _S_o_f_t_w_a_r_e _I_n_s_t_a_l_l_a_t_i_o_n _a_n_d _L_i_c_e_n_s_i_n_g _G_u_i_d_e for
  185.        complete installation instructions.
  186.  
  187.        2.5  _P_r_e_r_e_q_u_i_s_i_t_e_s
  188.  
  189.        If Performance Co-Pilot is to be installed in a ccccoooolllllllleeeeccccttttoooorrrr
  190.        ccccoooonnnnffffiiiigggguuuurrrraaaattttiiiioooonnnn then the _l_i_b_i_r_i_x_p_m_d_a._s_o library is required to
  191.        export performance metrics from IRIX.
  192.  
  193.        The following table describes where to locate the
  194.        appropriate version of _l_i_b_i_r_i_x_p_m_d_a._s_o.
  195.  
  196.             _________________________________________________
  197.              IRIX           Source of _l_i_b_i_r_i_x_p_m_d_a._s_o
  198.             __________________________________________________________________________________________________
  199.                     /_u_s_r/_p_c_p/_l_i_b/_l_i_b_i_r_i_x_p_m_d_a._s_o is shipped
  200.                     as part of the IRIX _p_c_p__e_o_e._s_w._e_o_e
  201.                     subsystem.
  202.              6.5
  203.  
  204.  
  205.             _________________________________________________
  206.                     The files
  207.                     /_u_s_r/_p_c_p/_l_i_b/_m_i_p_s_*./_l_i_b_i_r_i_x_p_m_d_a._s_o
  208.                     should be installed from the IRIX patch
  209.                     ppppaaaattttcccchhhhSSSSGGGG0000000000002222888822228888....eeeeooooeeee____sssswwww....ppppeeeerrrrffff that is
  210.                     included with the Performance Co-Pilot
  211.                     distribution.  This patch updates the
  212.                     IRIX 6.4 _e_o_e._s_w._p_e_r_f subsystem.
  213.              6.4
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.             _________________________________________________
  221.                     The files
  222.                     /_u_s_r/_p_c_p/_l_i_b/_m_i_p_s_*./_l_i_b_i_r_i_x_p_m_d_a._s_o
  223.                     should be installed from the IRIX patch
  224.                     ppppaaaattttcccchhhhSSSSGGGG0000000000002222888822227777....eeeeooooeeee____sssswwww....ppppeeeerrrrffff that is
  225.                     included with the Performance Co-Pilot
  226.                     distribution.  This patch updates the
  227.                     IRIX 6.3 _e_o_e._s_w._p_e_r_f subsystem.
  228.              6.3
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.             _________________________________________________
  236.                     The files
  237.                     /_u_s_r/_p_c_p/_l_i_b/_m_i_p_s_*./_l_i_b_i_r_i_x_p_m_d_a._s_o
  238.                     should be installed from the IRIX patch
  239.                     ppppaaaattttcccchhhhSSSSGGGG0000000000002222888822226666....eeeeooooeeee____sssswwww....ppppeeeerrrrffff that is
  240.                     included with the Performance Co-Pilot
  241.                     distribution.  This patch updates the
  242.              6.2
  243.  
  244.  
  245.  
  246.  
  247.             _________________________________________________
  248.             ||||||||||||||||||||||||||
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.                   ||||||||||||||||||||||||||
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.                                                              ||||||||||||||||||||||||||
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.                                   - 4 -
  337.  
  338.  
  339.  
  340.                     IRIX 6.2 _e_o_e._s_w._p_e_r_f subsystem.
  342.        _________________________________________________
  343.                /_u_s_r/_l_i_b/_p_c_p/_l_i_b_i_r_i_x_p_m_d_a._s_o should be
  344.                installed from the IRIX patch
  345.                ppppaaaattttcccchhhhSSSSGGGG0000000000002222888822225555....eeeeooooeeee2222____sssswwww....ppppeeeerrrrffff included
  346.                with the Performance Co-Pilot
  347.                distribution.  This patch updates the
  348.                IRIX 5.3 _e_o_e_2._s_w._p_e_r_f subsystem.
  349.         5.3
  350.  
  351.  
  352.  
  353.  
  354.  
  355.        _________________________________________________
  356.        ||||||||
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.              ||||||||
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.                                                         ||||||||
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.        For hosts in a PCP mmmmoooonnnniiiittttoooorrrr----oooonnnnllllyyyy ccccoooonnnnffffiiiigggguuuurrrraaaattttiiiioooonnnn which are
  380.        upgraded to PCP 2.0 and used to monitor remote PCP collector
  381.        hosts runnning PCP 1.x, the IRIX metrics must appear in the
  382.        local Performance Metrics Name Space (PMNS) on the PCP
  383.        monitor host.
  384.  
  385.        For IRIX 6.5 systems, the IRIX metrics are included in the
  386.        PMNS from the _p_c_p__e_o_e._s_w._e_o_e subsystem, so there is no
  387.        issue.
  388.  
  389.        For systems running earlier IRIX releases, the IRIX metrics
  390.        are included with the _l_i_b_i_r_i_x_p_m_d_a patches, as described in
  391.        the table above.
  392.  
  393.        The work around then, even if ppppmmmmccccdddd(1) is not running, is to
  394.        install the appropriate _l_i_b_i_r_i_x_p_m_d_a patch on the PCP monitor
  395.        system, and then run the following commands as rrrrooooooootttt:
  396.  
  397.            # cd /var/pcp/pmns
  398.            # ./Rebuild -du
  399.  
  400.        There is no issue if the remote PCP collector hosts are
  401.        running PCP 2.0 as the distributed name space services will
  402.        be used in preference to any local PMNS.
  403.  
  404.        The _p_c_p__e_o_e._b_o_o_k_s.* subsystems require the _i_n_s_i_g_h_t._s_w images
  405.        (IRIX 5.3) or the _i_n_s_i_g_h_t__b_a_s_e._s_w images (IRIX 6.2 or later)
  406.        to be installed.
  407.  
  408.        The _p_c_p__e_o_e._s_w._m_o_n_i_t_o_r utilities require dynamic shared
  409.        libraries from the subsystems: _V_i_e_w_K_i_t__e_o_e._s_w._b_a_s_e and
  410.        _i_n_v_e_n_t_o_r__e_o_e._s_w._i_n_v_e_n_t_o_r (version 2.1 or later).
  411.  
  412.        If the Performance Metrics Collector Daemon (PMCD) is
  413.        already running on the system to which the new installation
  414.        is going to be applied, then you must terminate ppppmmmmccccdddd before
  415.        starting the installation.  Similarly, any instance of the
  416.        ppppmmmmllllooooggggggggeeeerrrr utility should be terminated.  For example, use the
  417.        following commands as rrrrooooooootttt:
  418.  
  419.            # /etc/init.d/pcp stop
  420.            # killall -INT pmlogger
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.                                   - 5 -
  433.  
  434.  
  435.  
  436.        This is necessary because the subsystems to be installed
  437.        include new versions of shared libraries (DSOs) that may be
  438.        used by these PCP utilities.
  439.  
  440.        2.6  _C_o_n_c_u_r_r_e_n_t__I_R_I_X__U_p_g_r_a_d_e_s
  441.  
  442.        If you have PCP 1.x installed and are concurrently upgrading
  443.        IRIX and PCP, or have PCP 2.0 installed and are upgrading
  444.        IRIX, then there are some complex product interdependencies
  445.        that are best addressed by following the recommended
  446.        procedures below.
  447.  
  448.        IIIIRRRRIIIIXXXX 5555....3333 aaaannnndddd PPPPCCCCPPPP 1111....xxxx ttttoooo IIIIRRRRIIIIXXXX 6666....2222 aaaannnndddd PPPPCCCCPPPP 2222....0000
  449.  
  450.          1.  If the system is configured as a PCP ccccoooolllllllleeeeccccttttoooorrrr, then
  451.              force the removal of _p_c_p._s_w._c_o_l_l_e_c_t_o_r, i.e.
  452.                  # versions -F remove pcp.sw.collector
  453.  
  454.          2.  Upgrade IRIX.
  455.  
  456.          3.  Install _p_c_p__e_o_e and upgrade _p_c_p from the PCP 2.0 CD.
  457.  
  458.        IIIIRRRRIIIIXXXX 5555....3333 aaaannnndddd PPPPCCCCPPPP 2222....0000 ttttoooo IIIIRRRRIIIIXXXX 6666....2222 aaaannnndddd PPPPCCCCPPPP 2222....0000
  459.  
  460.        In this case it is possible to perform both upgrades
  461.        concurrently, but this involves a fair degree of CD swapping
  462.        and delaying the conflict resolutions.
  463.  
  464.        A simpler solution is:
  465.  
  466.          1.  Force the removal of _p_c_p and _p_c_p__e_o_e, but none of the
  467.              add-ons products which depend on _p_c_p or _p_c_p__e_o_e (e.g.
  468.              _p_c_p__w_e_b or _p_c_p__o_r_a_7) as these dependencies will be
  469.              again satisfied once PCP 2.0 is installed, i.e.
  470.                  # versions -F remove pcp pcp_eoe
  471.  
  472.          2.  Upgrade IRIX.
  473.  
  474.          3.  Re-install _p_c_p__e_o_e and _p_c_p from the PCP 2.0 CD.
  475.  
  476.        For information about upgrading IRIX to IRIX 6.5, please
  477.        also refer to the release notes for _p_c_p__e_o_e in the IRIX 6.5
  478.        distribution.
  479.  
  480.        IIIIRRRRIIIIXXXX 6666....2222 aaaannnndddd PPPPCCCCPPPP 1111....xxxx ttttoooo IIIIRRRRIIIIXXXX 6666....5555 aaaannnndddd PPPPCCCCPPPP 2222....0000
  481.        IIIIRRRRIIIIXXXX 5555....3333 aaaannnndddd PPPPCCCCPPPP 1111....xxxx ttttoooo IIIIRRRRIIIIXXXX 6666....5555 aaaannnndddd PPPPCCCCPPPP 2222....0000
  482.        IIIIRRRRIIIIXXXX 6666....2222 aaaannnndddd PPPPCCCCPPPP 2222....0000 ttttoooo IIIIRRRRIIIIXXXX 6666....5555 aaaannnndddd PPPPCCCCPPPP 2222....0000
  483.        IIIIRRRRIIIIXXXX 5555....3333 aaaannnndddd PPPPCCCCPPPP 2222....0000 ttttoooo IIIIRRRRIIIIXXXX 6666....5555 aaaannnndddd PPPPCCCCPPPP 2222....0000
  484.  
  485.        In all cases, use the PCP 2.0 CD concurrent with the IRIX
  486.        CDs to install or upgrade _p_c_p__e_o_e and upgrade _p_c_p at the
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.  
  497.  
  498.                                   - 6 -
  499.  
  500.  
  501.  
  502.        same time that all IRIX upgrades are done.
  503.  
  504.        Note that the _p_c_p__e_o_e subsystem is part of IRIX and is on
  505.        the Foundation-2 CD, whereas the _p_c_p subsystems for IRIX 6.5
  506.        are on the PCP 2.0 CD.  Concurrent installations are best
  507.        performed using the ooooppppeeeennnn command to select products from
  508.        multiple CDs.  For further details, refer to the _I_R_I_X _A_d_m_i_n:
  509.        _S_o_f_t_w_a_r_e _I_n_s_t_a_l_l_a_t_i_o_n _a_n_d _L_i_c_e_n_s_i_n_g _G_u_i_d_e.
  510.  
  511.        2.7  _P_o_s_t_-_I_n_s_t_a_l_l_a_t_i_o_n__P_r_o_c_e_d_u_r_e_s
  512.  
  513.        If the Performance Metrics Collector Daemon (PMCD) is to be
  514.        started (i.e. this system is to be a PCP collector) use the
  515.        following commands as rrrrooooooootttt:
  516.  
  517.            # chkconfig pmcd on
  518.            # /etc/init.d/pcp start
  519.  
  520.        Refer to the ppppmmmmccccdddd(1) man page for more details.
  521.  
  522.        For IRIX 6.5, the cccchhhhkkkkccccoooonnnnffffiiiigggg option for ppppmmmmccccdddd defaults to
  523.        ``on'', otherwise it defaults to ``off''.
  524.  
  525.        2.8  _C_o_m_p_a_t_i_b_i_l_i_t_y
  526.  
  527.        PCP 2.0 involves some evolutionary changes that may affect
  528.        some PCP upgrades and PCP add-on products and/or
  529.        applications developed using the PCP libraries.  Refer to
  530.        section 3 of these release notes and the _p_c_p release notes
  531.        for a complete discussion of these issues.
  532.  
  533.        2.9  _C_o_n_f_i_g_u_r_a_t_i_o_n__F_i_l_e_s
  534.  
  535.        It is expected that no configuration changes will be
  536.        required for the _p_c_p__e_o_e product, however if the _p_c_p product
  537.        is also installed, then a variety of site-specific
  538.        customizations may be involved.  Refer to the _p_c_p release
  539.        notes for more details.
  540.  
  541.        2.10  _F_i_l_e_s__N_o_t__L_i_s_t_e_d__b_y_vvvveeeerrrrssssiiiioooonnnnssss
  542.  
  543.           +o /_v_a_r/_a_d_m/_p_c_p_l_o_g - the diagnostic logs from ppppmmmmccccdddd and
  544.             PMDAs for a PCP collector configuration reside here.
  545.        If the _p_c_p product is also installed, then additional files
  546.        may be present.  Refer to the _p_c_p release notes for more
  547.        details.
  548.  
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.                                   - 7 -
  565.  
  566.  
  567.  
  568.        2.11  _O_t_h_e_r__I_n_s_t_a_l_l_a_t_i_o_n__I_n_f_o_r_m_a_t_i_o_n
  569.  
  570.        After installation has completed you should run the command
  571.  
  572.            showfiles -c -C -H pcp_eoe
  573.  
  574.        This will list files that have been customized for your site
  575.        and that were changed at the most recent _p_c_p__e_o_e
  576.        installation.  Existing files moved aside will have a ....OOOO
  577.        extension and new files that were not installed will have a
  578.        ....NNNN extension.  You must reconcile any differences between
  579.        the files by hand.
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  
  603.  
  604.  
  605.  
  606.  
  607.  
  608.  
  609.  
  610.  
  611.  
  612.  
  613.  
  614.  
  615.  
  616.  
  617.  
  618.  
  619.  
  620.  
  621.  
  622.  
  623.  
  624.  
  625.  
  626.  
  627.